<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="AAuto" />
<title>文件读写</title>
<link href="../../../style.css" rel="stylesheet" type="text/css" />
</head>

<body>
<div id="maincontent">
		<h1>fsys.file库</h1>
		<div class="desc">fsys.file库提供对文件读写操作的函数。</div>
		<div>
				<h2>fsys.file 构造函数</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file = fsys.file( path ,mode ,sharemode ,creation ,attrib ,secAttrib ,template )</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>创建一个文件操作句柄(fsys.file对象)。<br />
						构造参数与API函数CreateFile基本一致,请参考API手册! </p>
				<p><strong>3、函数示例：</strong></p>
				<div class="codeblock"> <span class="kw">import</span> fsys.file;<br />
						<span class="comment">// 初始化一个 fsys.file 类</span><br />
						<span class="kw">var</span> file = fsys.file(<span class="string">"D:\readme.txt"</span>, <span class="string">"r+"</span>);<br />
				</div>
				<div class="tip"><img src="../../../icon/info.gif" alt="" width="16" height="16" align="absmiddle" />注意：本文档以下所有的 file句柄 均为 fsys.file 这个类的实例。</div>
		</div>
		<!--fsys.file-->
		<div>
				<h2>file.read</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file.read( len )</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>参数len可选、默认为空。</p>
				<blockquote class="padleft">空 ：读取一行文本，不包括回车和换行符。<br />
						-1 ： 读取所有内容到文件尾部。<br />
						字节数 ： 读取指定长度的字节。 </blockquote>
				<p><strong>3、函数示例：</strong></p>
				<div class="codeblock"><span class="comment">//读取一行文本</span><br />
						<span class="kw">var</span> str = file.read();<br />
						io.print( str ); </div>
		</div>
		<!--file.read-->
		<div>
				<h2>file.write</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file.write( str )</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>写字符串到当前指针处。</p>
				<p><strong>3、函数示例：</strong></p>
				<div class="codeblock"><span class="comment">//写字符串到文件</span><br />
						file.write(<span class="string">"Hello world!"</span>) </div>
		</div>
		<!--file.write-->
		<div>
				<h2>file.seek</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file.seek( mode [,off=0 ] )</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>移动操作位置指针。<br />
						参数off可选，相对于mode位置的偏移量，默认为0。<br />
						参数mode：</p>
				<blockquote class="padleft">set ：移动指针到开始处。<br />
						cur ：得到当前位置。<br />
						end ：移动指针至结束处。 </blockquote>
				<p><strong>3、函数示例：</strong></p>
				<div class="codeblock"> file.seek(<span class="string">"cur"</span>)<span class="comment">//得到当前位置</span><br />
						file.seek(<span class="string">"set"</span>)<span class="comment">//<span class="padleft">移动指针到开始处</span></span><span class="padleft"></span></div>
		</div>
		<!--file.seek-->
		<div>
				<h2>file.getFileTimes</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file.getFileTimes()</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>返回创建时间、最后修改时间、最后访问时间。<br />
						返回值为table对象：</p>
				<blockquote class="padleft">table.creation ：文件创建时间。<br />
						table.access ：文件最后访问时间。<br />
						table.write  ：文件最后修改时间。</blockquote>
				<p><strong>3、函数示例：</strong></p>
				<div class="codeblock"><span class="kw">var</span> tm = file.getFileTimes();<br />
						io.print(tm.write,tm.access,tm.creation);</div>
		</div>
		<!--file.getFileTimes-->
		<div>
				<h2>file.setFileTimes</h2>
				<p><strong>1、函数原型：</strong></p>
				<pre>file.setFileTimes( tm )</pre>
				<p><strong>2、函数说明：</strong></p>
				<p>修改创建时间、最后修改时间、最后访问时间，<br />
						参数必须请使用getFileTimes()函数返回的对象</p>
				<div class="tip"><img src="../../../icon/info.gif" width="16" height="16" align="absmiddle" />参数tm必须是一个table对象，并且creation,access,write成员必须是合法的time对象</div>
		</div>
		<!--file.setFileTimes--> 
</div>
</body>
</html>